Skip to content

Add VTAdmin Operator's Guide#1012

Merged
doeg merged 5 commits intoprodfrom
sarabee-operators-guide
Jun 27, 2022
Merged

Add VTAdmin Operator's Guide#1012
doeg merged 5 commits intoprodfrom
sarabee-operators-guide

Conversation

@doeg
Copy link
Contributor

@doeg doeg commented Apr 13, 2022

Signed-off-by: Sara Bee 855595+doeg@users.noreply.github.com

Deploy previews:

This does not cover the changes proposed in vitessio/vitess#10543, nor single-component VTAdmin (which would simplify this a lot). Neither does it go into much detail about deployment specifics (Docker, k8s, etc.).

@netlify
Copy link

netlify bot commented Apr 13, 2022

Deploy Preview for vitess ready!

Name Link
🔨 Latest commit c6d81c1
🔍 Latest deploy log https://app.netlify.com/sites/vitess/deploys/62b9ade2bb3c2b00070e453b
😎 Deploy Preview https://deploy-preview-1012--vitess.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site settings.

@ajm188 ajm188 self-requested a review April 14, 2022 13:26
Copy link
Contributor

@ajm188 ajm188 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is looking good!! i like the structure you're setting up with the operators guide page

@doeg
Copy link
Contributor Author

doeg commented May 6, 2022

I'm going to pull out the vtadmin(-api) and vtadmin-web reference pages into separate PRs. The skeletal operator's guide in this branch be changing a bunch once single-component vtadmin lands (vitessio/vitess#10118), but the program reference makes sense to commit now.

@doeg doeg force-pushed the sarabee-operators-guide branch 3 times, most recently from a0744be to 453c8dd Compare June 25, 2022 12:51
Signed-off-by: Sara Bee <855595+doeg@users.noreply.github.com>
@doeg doeg force-pushed the sarabee-operators-guide branch from f570b46 to 8c6eaff Compare June 25, 2022 13:02
Signed-off-by: Sara Bee <855595+doeg@users.noreply.github.com>
@doeg doeg marked this pull request as ready for review June 25, 2022 13:06
@doeg doeg requested a review from ajm188 June 25, 2022 13:07
Signed-off-by: Sara Bee <855595+doeg@users.noreply.github.com>
Copy link
Contributor

@ajm188 ajm188 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this looks great to me! (and thank you for putting this together! ❤️), i found one issue i think needs to be addressed, and one other "just curious" question, but i'm happy to merge after that first thing is addressed


## Prerequisites

- Building `vtadmin-web` requires [node](https://nodejs.org/en/) >= v16.13.0.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

there's technically an issue if you go to >= 17.0.0 (see https://github.com/vitessio/vitess/blob/main/web/vtadmin/README.md#prerequisites), which we might want to call out here

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As a side note, it's possible to specify a more precise node version in the package.json engine property.

For example:

  • "node": "^16.13.0" allows versions that does not increment the first non-zero portion of semver; e.g., it includes 16.13, 16.420, and 16.99; it does not include 16.12 or 17.x. (Probably best?)
  • "node": "16.13.0" disallows any other version.

The version is enforced (albeit weakly + not exactly how you'd expect or want) by way of the .npmrc file and will fail npm install when run with an unspecified version. More on that here: https://docs.npmjs.com/cli/v8/using-npm/config#engine-strict

doeg added 2 commits June 27, 2022 09:07
Signed-off-by: Sara Bee <855595+doeg@users.noreply.github.com>
Signed-off-by: Sara Bee <855595+doeg@users.noreply.github.com>
Copy link
Contributor

@ajm188 ajm188 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks fantastic! is there anything else you want to get in this PR, or should I (or you!) merge now?

@doeg
Copy link
Contributor Author

doeg commented Jun 27, 2022

@ajm188 I can merge. Thanks for taking another look!

@doeg doeg merged commit fd29366 into prod Jun 27, 2022
@doeg doeg deleted the sarabee-operators-guide branch June 27, 2022 17:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants